home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / librpc-xml-perl / README < prev    next >
Text File  |  2008-09-29  |  2KB  |  81 lines
  1. RPC::XML - An implementation of XML-RPC
  2.  
  3. Version: 0.64
  4.  
  5. WHAT IS IT
  6.  
  7. The RPC::XML package is an implementation of XML-RPC. The module provides
  8. classes for sample client and server implementations, a server designed as an
  9. Apache location-handler, and a suite of data-manipulation classes that are
  10. used by them.
  11.  
  12.  
  13. USING RPC::XML
  14.  
  15. There are not any pre-packaged executables in this distribution (except for a
  16. utility tool). Client usage will usually be along the lines of:
  17.  
  18.     use RPC::XML::Client;
  19.     ...
  20.     my $client = new RPC::XML::Client
  21.         'http://www.oreillynet.com/meerkat/xml-rpc/server.php';
  22.     my $req = RPC::XML::request->new('meerkat.getChannelsBySubstring', 'perl');
  23.     my $res = $client->send_request($req);
  24.     # This returns an object of the RPC::XML::response class. This double-call
  25.     # of value() first gets a RPC::XML::* data object from the response, then
  26.     # the actual data from it:
  27.     my $value = $res->value->value;
  28.  
  29. Running a simple server is not much more involved:
  30.  
  31.     use RPC::XML::Server;
  32.     ...
  33.     my $srv = new RPC::XML::Server (host => 'localhost',
  34.                                     port => 9000);
  35.     # You would then use $srv->add_method to add some remotely-callable code
  36.     ...
  37.     $srv->accept_loop; # Stays in an accept/connect loop
  38.  
  39.  
  40. BUILDING/INSTALLING
  41.  
  42. This package is set up to configure and build like a typical Perl extension.
  43. To build:
  44.  
  45.         perl Makefile.PL
  46.         make && make test
  47.  
  48. If RPC::XML passes all tests, then:
  49.  
  50.         make install
  51.  
  52. You may need super-user access to install.
  53.  
  54.  
  55. PROBLEMS/BUG REPORTS
  56.  
  57. Please send any reports of problems or bugs to rjray@blackperl.com
  58.  
  59.  
  60. SEE ALSO
  61.  
  62. XML-RPC:          http://www.xmlrpc.com/spec
  63. The Artistic 2.0: http://www.opensource.org/licenses/artistic-license-2.0.php
  64. The LGPL 2.1:     http://www.opensource.org/licenses/lgpl-2.1.php
  65.  
  66.  
  67. CHANGES
  68.  
  69. t/40_server.t:
  70. Further flexibility on the test of $srv->url(). This should (finally)
  71. catch any variation of 127.* address and/or host/domain naming that
  72. aliases to "localhost".
  73.  
  74. lib/RPC/XML/Parser.pm:
  75. t/20_parser.t:
  76. Lingering problem from RT ticket #30354, RPC::XML::Parser did not get
  77. the change committed that included parser-level support for <i8>. Also
  78. added tests for parsing RPC::XML::request objects and all the data-type
  79. objects to the parser test suite (had they been there before, I would
  80. have caught this myself).
  81.